Crate iroh_net

iroh-net provides connectivity for iroh.

This crate is a collection of tools to establish connectivity between peers. At the high level MagicEndpoint is used to establish a QUIC connection with authenticated peers, relaying and holepunching support.

The “derp-only” feature forces all traffic to send over the derp relays. We still receive traffic over udp and relay. This feature should only be used for testing.

Re-exports

• pub use magic_endpoint::AddrInfo;
• pub use magic_endpoint::MagicEndpoint;
• pub use magic_endpoint::PeerAddr;

Modules

• config
  Configuration types.
• defaults
  Default values used in iroh-net
• derp
  Package derp implements the Designated Encrypted Relay for Packets (DERP) protocol written by Tailscale. DERP routes packets to clients using curve25519 keys as addresses. DERP is used by proxy encrypted QUIC packets through the DERP servers when a direct path cannot be found or opened. DERP is a last resort. Both side between very aggressive NATs, firewalls, no IPv6, etc? Well, DERP. Based on tailscale/derp/derp.go
• key
  Cryptographic key handling for iroh-net.
• magic_endpoint
  An endpoint that leverages a quinn::Endpoint backed by a magicsock::MagicSock.
• magicsock
  Implements a socket that can change its communication path while in use, actively searching for the best way to communicate.
• metrics
  Co-locating all of the iroh-net metrics structs
• net
  Networking related utilities
• netcheck
  Checks the network conditions from the current host.
• ping
  Allows sending ICMP echo requests to a host in order to determine network latency.
• portmapper
  Port mapping client and service.
• stun
  STUN packets sending and receiving.
• tls
  TLS configuration based on libp2p TLS specs.
• util
  Utilities used in iroh-net